home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / src / cmds / ln / RCS / ln.man,v < prev   
Encoding:
Text File  |  1990-01-31  |  3.1 KB  |  159 lines
  1. head     1.3;
  2. branch   ;
  3. access   ;
  4. symbols  ;
  5. locks    ; strict;
  6. comment  @@;
  7.  
  8.  
  9. 1.3
  10. date     90.01.31.14.48.02;  author jhh;  state Exp;
  11. branches ;
  12. next     1.2;
  13.  
  14. 1.2
  15. date     88.12.29.16.01.13;  author ouster;  state Exp;
  16. branches ;
  17. next     1.1;
  18.  
  19. 1.1
  20. date     88.12.29.15.52.36;  author ouster;  state Exp;
  21. branches ;
  22. next     ;
  23.  
  24.  
  25. desc
  26. @@
  27.  
  28.  
  29. 1.3
  30. log
  31. @made remote links more general
  32. @
  33. text
  34. @.\" Copyright (c) 1980 Regents of the University of California.
  35. .\" All rights reserved.  The Berkeley software License Agreement
  36. .\" specifies the terms and conditions for redistribution.
  37. .\"
  38. .\"    @@(#)ln.1    6.3 (Berkeley) 11/26/86
  39. .\"
  40. .TH LN 1 "November 26, 1986"
  41. .UC 4
  42. .SH NAME
  43. ln \- make links
  44. .SH SYNOPSIS
  45. .B ln
  46. [
  47. .B \-s | \-r
  48. ]
  49. sourcename [ targetname ]
  50. .br
  51. .B ln
  52. [
  53. .B \-s | \-r
  54. ]
  55. sourcename1 sourcename2 [ sourcename3 ... ] targetdirectory
  56. .br
  57. .SH DESCRIPTION
  58. A link is a directory entry referring
  59. to a file; the same file (together with
  60. its size, all its protection
  61. information, etc.)
  62. may have several links to it.
  63. There are three kinds of links: hard links, symbolic links,
  64. and remote links.
  65. .PP
  66. By default
  67. .I ln
  68. makes hard links.
  69. A hard link to a file is indistinguishable from the
  70. original directory entry; any changes to a
  71. file are effective independent of the name used
  72. to reference the file.  Hard links may not refer to directories
  73. (unless the proper incantations are supplied) and may not span
  74. file systems.
  75. .PP
  76. The
  77. .B \-s
  78. option causes
  79. .I ln
  80. to create symbolic links.
  81. A symbolic link contains the name of the file to
  82. which it is linked.  The referenced file is used when an
  83. .IR open (2)
  84. operation is performed on the link.
  85. A
  86. .IR stat (2)
  87. on a symbolic link will return the linked-to file; an
  88. .IR lstat (2)
  89. must be done to obtain information about the link.
  90. The
  91. .IR readlink (2)
  92. call may be used to read the contents of a symbolic link.
  93. Symbolic links may span file systems and may refer to directories.
  94. .PP
  95. Given one or two arguments,
  96. .I ln
  97. creates a link to an existing file
  98. .IR sourcename .
  99. If
  100. .I targetname
  101. is given, the link has that name;
  102. .I targetname
  103. may also be a directory in which to place the link;
  104. otherwise it is placed in the current directory.
  105. If only the directory is specified, the link will be made
  106. to the last component of
  107. .IR sourcename .
  108. .PP
  109. Given more than two arguments,
  110. .I ln
  111. makes links in 
  112. .I targetdirectory
  113. to all the named source files.
  114. The links made will have the same name as the files being linked to.
  115. .PP
  116. The \fB-r\fR option causes \fIln\fR to create remote links at the given
  117. location.  Remote links are special files that identify places in
  118. Sprite where
  119. file system domains are attached to their parent domains.
  120. The source of a remote link must be an absolute path.
  121. In the normal case the source and target should be the same,
  122. ie. "ln -r /foo /foo".
  123. .SH "SEE ALSO"
  124. rm(1), cp(1), mv(1), link(2), readlink(2), stat(2), symlink(2)
  125. @
  126.  
  127.  
  128. 1.2
  129. log
  130. @Document special -r Sprite switch.
  131. @
  132. text
  133. @d14 1
  134. a14 1
  135. .B \-s
  136. d20 1
  137. a20 1
  138. .B \-s
  139. a23 1
  140. \fBln \-r \fRsourcename
  141. d30 2
  142. a31 1
  143. There are two kinds of links: hard links and symbolic links.
  144. d83 1
  145. a83 1
  146. The \fB-r\fR option causes \fIln\fR to make a remote link at the given
  147. d87 3
  148. @
  149.  
  150.  
  151. 1.1
  152. log
  153. @Initial revision
  154. @
  155. text
  156. @d23 2
  157. d82 5
  158. @
  159.